SGPanelSetResFile(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 7 - Sequence Grabber Panel Components / Sequence Grabber Panel Components Reference

Functions / Managing Your Panel Component

SGPanelSetResFile
Unless you instruct it otherwise, the sequence grabber component opens your panel component's resource file for you. The SGPanelSetResFile function allows the sequence grabber to pass you the resource file's reference number. The sequence grabber also calls this function when it closes your resource file.
pascal ComponentResult SGPanelSetResFile 
                                       (SeqGrabPanelComponent s,
                                        short resRef);
s
Identifies the sequence grabber component's connection to your panel component.
resRef
Contains a reference number that identifies your component's resource file. After it closes your resource file, the sequence grabber component calls this function and sets this value to 0.

DESCRIPTION
A sequence grabber component calls your SGPanelSetResFile function in order to pass you your component's resource file reference number. By default, the sequence grabber component opens your component's resource file for you. You can use this reference number to retrieve resources from your resource file.
The sequence grabber component also calls this function when it closes your component's resource file. In this case, it sets the resRef parameter to 0. Note that the sequence grabber component may close your resource file at any time; you should not count on any particular calling sequence.
If you do not want the sequence grabber component to open your resource file, set the channelFlagDontOpenResFile component flag to 1.